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Introduction 

September-October '88 ReRUN 

THERE ARE 14 PROGRAMS in this September-October edition of 
ReRUN, with a good mix of C-64 and CM 28 programs, plus some 
that operate in both 64 and 128 modes. I think you'll find their 
quality is lop-notch. 

In the first September program, Try To Remember, for the C-64, 
you're briefly shown a list of five words to commit to memory. The 
list quickly disappears, and one of the five words reappears as a 
string of dashes, with only one letter filled in. You must try to recall 
the word and, using your joystick, select the missing letters in their 
correct order from an alphabetical grid. I think you'll find it a 
challenging program for computerists of all ages. 

Next, we're offering a great C-64 programming utility called Pro- 
grammer's Pager. This interrupt-driven program allows you to dis- 
play a Basic program one screen at a lime, and it also features a 
highlighting bar to highlight lines of code. 

Next, for the entertainment of card players, there is Knock!, a 64/ 
128 variation of the popular card game, 31. Your opponents reside 
in the computer, and you'll find them a clever bunch of players 

indeed. . , 

Inertia Mania, one of the largest purely machine language C-64 
arcade programs ever published in a computer magazine, is also 
from our September issue. You're given a limited amount of time 
to guide a bouncing ball down corridors while collecting gold pieces 
and dodging cannon fire. This is arcade excitement at its best. 

Our September Easy Applications program, Vacation List Gen- 
erator, for either the 64 or the 1 28, creates exactly what its name 
implies: a checklist of camping and vacation gear. You can easily 
customize the list so it details your personal camping or vacationing 
belongings. 

September's Mega-Magic program, Kracking the Kernal, ts an 
exciting tutorial on programming. Veteran programmer John Ryan 
gives advice and examples on putting the C-64's powerful Kernal 
routines to work. 

October's programs begin with Songs in the Key of C-128, a 
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How To Load 



Loading from Menu 

To get started, C-64 users should type LOAD "MENU 64",8 and press the 
return key. When you get the Ready prompt, the menu is loaded and you 
should type RUN to see a list of the programs on your disk. C-128 users need 
only press the shift and run-stop keys. When all the programs are displayed 
on the screen, you can run the one you select by pressing a single key. 

Loading from Keyboard 

If you do not wish to use the menu program, follow these instructions. 

C-64: To load a C-64 program written in Basic, type: LOAD "DISK FILE- 
NAME",8 and then press the return key. The drive will whir while the screen 
prims LOADING and then READY, with a flashing cursor beneath. Type 
RUN and press the return key. The program will then start running. To 
load a C-64 program written in machine language (ML), type: LOAD "DISK 
FILENAME" ,8,1 

C-128: All C-64 programs can be run on the C-128 as long as your computer 
is in C-64 mode. All C-128 programs are clearly labeled on the directory 
page. Your C-128 must be in C-128 mode to run these programs. To load a 
C-128 mode program, press the F2 key, type the disk filename and then 
press the return key. When the program has loaded, type RUN. 

Making Copies of ReRUN Files 

Many programs on your ReRUN disk have routines thai require a separate 
disk onto which the program writes or saves subfiles. To use these programs, 
you must first make a copy of the original program onto another disk that 
has enough free space on it to hold these newly written subfiles. 

It's simple to make a copy of a Basic program. Just load it into your 
computer as outlined above, and then save the program back onto a separate 
disk that has plenty of free space for extra files. 

Copying an ML program is not so simple. You cannot simply load and 
save an ML program; you'll need to use a disk-backup utility program, such 
as the one on your Commodore Test Demo disk. 
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Before ymi run 3 program, carefully reatl the documentation thai pertains to it. 
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RUN it right: C-64; joystick 



Try To Remember 



liy Penny DeOroff 



I REMEMBER IS A COMBINATION spelling and memory-improve- 
ment game that challenges you to remember and correctly spell lists 
of words in the shortest possible time. The nine difficulty levels 
each contain live words, with two-letter words al the first level, three- 
letter words at the second, and so forth. The game can be customized 
to fit anyone's ability. 

When you run the program, it briefly displays the five words at 
the first difficulty level; then the playfield appears. This field is a 
matrix of all the letters of the alphabet, with a light-blue ball in the 
center. Above the playfield is the time display. The computer picks 
one of the five words, then shows one clue letter from that word 
below the playfield, with the other letters represented by hyphens. 

The clock is ticking, so you'd better- start. Using a joystick in port 
2, move the blue ball to the letter you Lliink the first hyphen 
represents. Take care to move the ball in the spaces between the 
letters, for the hall turns yellow as soon as it touches any letter, and 
when it does, the die is cast: you have chosen thai letter. 

You can proceed to another letter only by guiding the (now) yellow 
ball to the star in the center of the playfield, at which point you 
hear a happy ping if your choice is correct, a dull bong if you're 
wrong. If you've chosen correctly, the letter will replace the hyphen; 
if not, try again. 

Continue until the entire word is displayed. Then you'll advance 
to tin- next level. 

Customizing the Program 

To change the length of lime that the lists of words arc shown, 
increase or decrease the 1000 in line 2(10 of the program. If you 
want to play only with shorter words, decrease the 10 in line 240. 
For example, if you'd like the game to end after the six-letter words, 
change the 10 to 0. 

You may want to replace some or all of (he words from time to 
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time. They're located in Data statements beginning at line (530, with 
the two-letter words in line 630, the three-letter words in line 640, 
and so forth. When you replace words, be sure they're the correct 
length for that level and that you keep five in each Data statement. 
I'd also recommend that, within each level, no two words have the 
same letter in the same position. For example, if "but" and "pet" 
were in a list, the program might select one of them and "t" as the 
ciue letter. Then, you couldn't guess the word until you'd chosen 
more letters, possibly wasting time. 



RUN it right: C-64 

Programmer's Pager 

By John Ryan 



PAGE LISTER IS A POWERFUL, albeit short, programming utility 
that takes the hassle out of listing Basic programs to the screen for 
study and debugging. No more will you have to type in LIST 
<line number> - <line number> over and over again to search for 
bugs. At the touch of a function key, Page Lister brings 24 lines of 
Basic text to the screen and leaves them there for your perusal and 
editing. As a bonus, a line-highlighting function is available to help 
eliminate the tedium of scanning for errors. Anyone who's tried to 
compare data between a magazine listing and the screen or who 
works with Data statements a lot will love this feature! 

When you want to use Page Lister, load and run it to generate 
the machine language program in its Data statements; then load the 
program you plan to work on. With both programs in memory, just 
tap the restore key to activate the Page Lister features. If you've 
forgotten to load your other program, a message appears to remind 
you. Otherwise, the screen goes blank and awaits your next keypress. 

Press Fl each time you want to examine a new batch ot 24 lines. 
At the end of the listing, the next Fl will begin recycling at the first 
tine number. To page backward through the listing, press F3. In this 
case, when it reaches the beginning of the listing, the paging stops; 
there's no cycling with F3. 
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F5 activates the highlight bar, the cursor keys move it up and 
down and another Ff> toggles it off. Pressing F7 exits from Page 
Lister. 

This utility works fine with all Basic programs except those with 
embedded list-protection features and those with machine language 
programs automatically appended to them by certain assemblers. 



RUN it right: C-64; C-128 

Knock! 

By John Fedor 



"I'LL BET YOU A NICKEL!" Okay, but how about $5? The winnings 
are up in Cards-31, a Commodore version of the traditional game 
in which you try to win a "pot" of nickels by getting a total score 
of 81, or as close to it as possible, with cards of the same suit. 
Numbered cards are worth their face value, face cards arc worth 10, 
and aces count 11. In this game, a pot of imaginary $5 bills is at 
stake instead of nickels. 

You can play up to four computerized opponents in Cards-31, or 
just sit out and watch them battle among themselves. The game 
starts with each player having three cards and $15. A discard pile 
is established with one card facing up. When it's your turn, you have 
four options: draw a card from the deck; draw the exposed card 
from the discard pile; knock (which you do when you're as close to 
31 as you figure you can get); or ask your expert opponent (the 
computer) to look at your cards and offer aclvice. If you ask for 
advice, don't worry — the machine won't remember your band when 
playing its own. 

If you draw from either (he deck or the discard pile, you must 
discard to keep only three cards in your hand. In general, drop a 
card that's not of the same suit as two others in your hand or that's 
of less value than the others. For instance, if you hold a jack and 
queen of spades and a king of diamonds and then draw a 9 of 
spades, drop the king of diamonds, [f you hold a 7, jack and king 
of hearts and draw a 10 of hearts, drop the 7. 
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You can choose to knock when you fee! you've reached the best 
score you're going to get, or when you chance to gel a fair score 
early in the round and judge that your opponents may not yet have 
collected much in one suit. After someone knocks, each of the other 
players gets one more turn to better his hand. This ends the round, 
and the scores are computed and displayed with the final hands. 

Only the cards in the suit each player holds the most of count in 
the scores of each round. For example, if you hold a 9 and 4 of hearts 
and a 10 of clubs, your score is 13 (9 + 4). If your cards are all in 
different suits, only the card with the highest value is counted. The 
maximum you can get for your three cards is the magic 31 (the ace 
plus two face cards or one face card and the 10, all in the same suit). 

As a round ends, each player whose score is less than the best 
loses $5 to the pot, and the amount in the pot is displayed, as well 
as the amount each player has remaining. The next round starts 
with the player after the one who knocked last. When you're out of 
money, you're out of the game, which continues until only one 
player has any money left — and he wins the pot! 

You'll find your computerized opponents the most skillful players 
this side of Las Vegas, and each has different instructions for when 
to knock. With the variety of play options available and the strategy 
involved, this version of 31 should keep you entertained for hours. 



RUN ii right: C-64; joystick 

Inertia Mania 

By Charles Orcutt 



IF YOU'VE NEVER BEEN in a rubber room, Rubber Bandit Ball 
provides a golden opportunity to feel what it's like. In this smooth- 
scrolling, multiscreen arcade game, you use a joystick in port 2 to 
control a rubber ball as it bounces through corridors, trying to 
snatch up little golden nuggets. Guiding the ball is hard enough, 
but merciless cannons fire killer balls through the corridors period- 
ically, and the rubber ball loses one of its five lives if it collides with 
one. A clock allows you 99 seconds to gather up all 95 nuggets, and 
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the ball also loses ;<. life if it runs out of time. When the ball docs 
gel all (he nuggets, you proceed to the next level, where the cannons 
fire faster killer balls more frequently. 

For each nugget snatched, you get the number of the current level 
in points. In other words, in level two, each nugget is worth two 
points. You pause the game by hitting the fire-button, and you start 
over again by pressing restore. 

Like most objects in this universe, the rubber ball has inertia, so 
it tends to continue in the direction it's going. As a result, moving 
the joystick is like blowing on the ball or pulling it with a spring; 
the effect is subtle and difficult to predict. Sometimes the ball gets 
mired in the wall (especially near the cannons), so be careful. You'll 
eventually learn how to avoid getting stuck. 

The high-score display on the game screen is valid only for the 
current session of play. Your top-ten high scores are stored, in 
descending order, on disk. When you run out of lives and play ends, 
the game boots the high-score file and checks to see whether your 
current score should be included. If so, enter your initials by moving 
the joystick up and down to cycle through the alphabet and left and 
right to move between your initials. When you press the fire-button, 
the new top-ten roster is saved and another game commences. The 
high-score routines of some games have you press the fire-button 
as you enter the letters. Be sure not to do that here, or you won't 
get your initials placed. 

In order to save Rubber Bandit Ball scores to disk, you must copy 
Rubber Bandit Ball and the program called Hi-Score to a work disk. 
Otherwise, the game won't save the top-ten list, and you'll gel garbage 
on the screen. 

Don't use a fast-load cartridge with Rubber Bandit Ball, My car- 
tridge causes errors when the program tries to store the high-score 
file, and I couldn't figure a way around the problem. Just use the 
standard Commodore DOS. 
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RUN it right: C-64; C-128 (40- or 80-Column mode); printer 

Vacation Checklist 
Generator 

Program by Lou Wallace; Article by Tim Walsh 



HOW DO YOU SPEND your well-deserved vacations? Whether you 
bask in the tropical sun of Antigua, stalk wild boar in the Maine 
Alagash or jusl pitch a couple of tents in the local swamp for a 
Saturday night of mosquito-slapping, you could use Vacation Check- 
list Generator. 

As its name implies. Vacation Checklist Generator allows you to 
produce a list of the items you're going to take on your trip. Many 
camping items are included on the list and automatically appear 
when the program is run. You simply need to answer Y or N at the 
prompts to add or skip an item on your list of equipment. Once it's 
completed to your satisfaction, you can print it out. 

When packing your car or suitcases, you check off each item 
against your printed list. Not only are these lists invaluable for 
packing when you leave home, but also for checking to see you 
haven't forgotten anything when you're leaving your campsite. This 
reduces the risk of not-so-funny whines on the ride home, such as, 
"Dad, I think we left the tackle box behind." You can reassure yourself 
and your offspring by showing that you checked off the tackle box 
beforehand. 

As written, the program's camping gear list was formed with the 
no-holds-barred camper in mind. Few vacationers have a need for 
a shotgun, hunting knife and camouflage when traveling to Disney- 
land, so the program permits you to skip any or all of the default 
camping equipment and create your own customized list by substi 
tuting items. 

As a notoriously ill-prepared camper, 1 view this program as the 
ultimate camping accessory. Never again will you accidentally leave 
anything behind, except, hopefully, your worries. 
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RUN it right: C-64 



Kracking the Kernal 



By John Ryan 



MANY BEGINNING PROGRAMMERS assume the C-64 Kernal is 
filled with 6502 subroutines that are as mysterious as hieroglyphics 
and used exclusively by machine language programmers. While this 
may be true to some extent, anyone can use Kernal routines to 
access the power and speed of the built-in ML routines without 
having to learn machine language. 

The Kernal Plot routine lets you position the cursor anywhere on 
the screen without using a lot of cursor commands. The three routines 
below show how to use the Plot routine in conjunction with the 
Kernal's line-clearing, line-insertion and screen-scrolling routines. 

Kernal 1 utilizes both the Kernal Plot routine and the Kernal 
routine that clears a screen line. This is useful for programs that 
need to clear only a portion of the video screen. It also clears the 
screen from the bottom up. To clear the screen from (he (op down, 
change line 30 to X = 0:Y = 0; then reverse the logic in line 60. If 
you want to use just the Plot routine at 65520 ($FFF0), set X = row 
(0-24) and Y = column (0-39); then place line 100 as a subroutine 
in your own program. 

Kernal 2 shows how to achieve rapid screen scrolling from Basic 
by using the Kernal routine at 5962C ($E8EA). This program prints 
a line of text at the bottom of the screen, then scrolls it to the lop. 

Finally, Kernal 3 scrolls text down the video screen. The Kernal 
routine at 59749 ($E965) is a subroutine the Kernal uses to insert a 
blank line on the screen. You can see this by listing a program, 
going to a line with fewer than 40 characters, then adding text until 
the 40-column boundary is crossed. Notice the extra blank line thai 
appears. 

Program 3 is called with the invisible cursor positioned at the top 
of the screen, just above the printed text. When the Insert routine 
is called, the computer automatically moves everything on the screen 
down as it adds a blank line. 
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The Kernal is for everyone who wants to squeeze every ounce of 
power from his C-64 without having to reinvent the wheel. Grab a 
memory map and explore the Kernal for yourself. Who knows what 
little ML gems you'll find for your Basic programs! 



RUN il right: C-128, in 80-Column mode; joystick; printer optional 

Songs in the Key of C-128 

!iy Barbara Sckvldk 



BETTER TUNE UP YOUR C-128! Music Editor 128 facilitates iran- 
scribing written music, whether your own or sheet music, into strings 
that can be used by the C-128 Play statement. It will also store the 
music as a sequential file on disk, so you can rework it later or use- 
it in your own programs. 

The Music Editor screen displays three menus and octaves 1-6 of 
the piano keyboard. The two bottom lines of the screen are reserved 
for input and program response. 

To select options from the menus, use a joystick plugged into port 
2. Move it up and down to highlight the choices; then press the fire- 
button to select the one you want. 

Menu 1 lets you access the editor (which leads to menus 2 and 3), 
load or save a file, print the file either to the screen or your printer, 
view the directory and set the tempo for the music. After you press 
the fire-button, a prompt appears at the bottom of the screen. Enter 
the necessary information, and the operation will proceed. To abort 
the operation, press the return key. You can also play all or part of 
the music from menu 1 by entering the starting and ending measures 
you want to hear. 

Keying In the Music 

To facilitate entering data, Music Editor works one measure at a 
time. Menu 2 lets you choose a measure to edit, start and end the 
measure and play it. You can also select the volume for each measure 
and the tuning envelope for each voice. I'd suggest using the first 
measure to define your tuning envelopes, so they can easily be 
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Keep in mind that Music Editor limits strings to 160 characters 
(two screen lines). You may have to divide a measure into two sections 
if your string is getting too long. 



RUN it right: C-64; C-128 in 40-Column mode; printer 

Instant Test-Maker 

By Hugh McMenamin 

OF ALL THE CHORES teachers have to face, the most time con- 
suming seems to be preparing and grading examinations. The Ques- 
tion Box program eliminates some of this drudgery by letting you 
construct a library of examination questions and then retrieve in- 
dividual questions to assemble into tests. 

Question Box, which works on both the C-64 and the C-128 in 
40-Column mode, handles al! the common forms of questions: mul- 
tiple-choice, true-false, fill-in-the-blank and essay. Individual ques- 
tions can be previewed from the Master file and selected either by 
you or, randomly, by the computer. The new Test file can then be 
printed out or stored to disk. As a bonus, you can include superscripts 
and subscripts in your questions. 

Here are instructions for using the Question Box's numerous 
commands. 

Entering Questions 

E (Enter) calls up the menu for selecting the type of question. 
The body of a question may consist of four lines of up to 60 characters 
each, with a — marker in reverse field indicating the 60-character 
limit. If you exceed the limit, the program will truncate the line 
automatically. 

To enter each line, press the return key. Also press return to enter 
null (empty) lines when no further text is desired, if you want 
additional space between the body of a multiple-choice, true-false 
or essay question and the answer, enter a shift/space. 

Note that commas and colons may be used in your entries, but 
quotation marks may not. 
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T (True-false) questions are automatically followed with the two 
responses to be circled: True False 

F (Fill-blank) requires you to construct the blank, (_ ), within 
the question by using the Commodore and @ keys simultaneously, 

E (Essay) mode provides for up to nine empty lines after the main 
body of the question. 

M (Multiple-choice) questions allow you to add four answers after 
the letters A-D, again within the 60-character limit per line. 

Each time you finish entering a question, you'll be asked if you 
want to add another. If your response is other than Y, the command 
screen will return. 

R (Review File) lists the number of each question in the Master 
file and 26 characters of the question's first line. The question type 
is also shown, in reverse field, for easy identification in using the 
Correct, Delete and Transfer modes. 

C (Correct) asks for the number of the question to be corrected, 
then displays the question, along with code numbers 0-7 for multiple- 
choice and 0-3 for the others. Null lines are indicated by a character 
space and period after the number (5 . ), while shift/space lines 
are indicated by a blank after the number (5 ). The line you select 
by entering a code number is displayed below a dashed line. Make 
your corrections, including commas and colons, then reenter the 
line by pressing return. 

Making Up Tests 

T (Transfer) mode lets you select individual questions to be trans- 
ferred from the Master file to the Test file. If you don't enter N at 
the prompt, the selected question will be appended to the Test file. 

N (New Test) moves a random selection of questions from the 
Master file to the Test file. Both Transfer and New Test limit Test 
file questions to 50. If New Test doesn't reach the 50-question limit, 
you can add other questions to the Test file individually. 

P (Print) allows printing from either the Master or Test file to the 
screen, disk or printer. When printing to the screen, the display will 
scroll about 20 lines. When printing to the printer, only complete 
questions will appear on a page; they won't wrap to the next page. 
Print-to-disk stores the data as ASCII characters, which then can be 
loaded into a word processor, such as RUN Script, for further 
revision. If you're using RUN Script, you can enter formatting codes 
with the Define Macros program (see RUN, January 1987). The print- 
lo-disk files are identified by a hyphen (-) preceding the filename. 
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Because of the difficulty in copying the miniature characters with 
some primers, I've provided for full-size super- and subscripts. How- 
ever, they work only with printers that allow you to reverse direction 
with the paper feed. Examples of these are the Epson FX-80 and 
emulators of the FX-80 series (the C.Itoh Prowriter Jr. and the Star 
NX- 1000, in Tractor mode only). 

Full-size is selected at the beginning of the printer option. The 
printer control codes are defined as the up string (up$) and down 
string (dn$) in line 140, and these strings are activated when you 
choose the full-size option. 

To initiate full-size superscripts, you press the I key, and you cancel 
them with the £ key. Subscripts are activated and cancelled with the 
reverse procedure: £ to activate, and I to cancel. With the Full-size 
characters, then, you'd print ten squared with 10t2£ and the formula 
for water with H£2lO. 

Operating Notes 

The Question Box is heavily dependent on string manipulation, 
which slows operation on the C-64 because of that machine's memory 
limitations. You can speed things up by placing a REM at the 
beginning of line 240 to negate the Fre(l) command, which performs 
the nonessential functions of calculating free space left and packing 
strings. 

If your computer seems to stop while you're running the Question 
Box, it's probably the result of garbage collection and not a complete 
lock-up. When this happens, wait for a minute or two to see if the 
program continues. If not, press run-stop/restore and enter GOTO 
190 to preserve your questions. 

If you possess Abacus's Basic 64, I'd highly recommend using it 
to compile the Question Box. Then it will work very well in C-64 
mode, even with line 240 fully operational. 

If your printer won't work with the Question Box, you may have 
to change the control codes in lines 140-170 to accommodate your 
interface. See your printer manual for these codes. 

Last but not least, be sure to save your questions to disk frequently. 
Then you won't have any test surprises! 
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RUN it right: C-64; C-128 (in 40-Column mode); printer 



Easy Banners 



By John Ryan 



WHETHER IT BE A BIRTHDAY PARTY for your five-year-old or a 
welcome-home celebration for a loved one, almost everyone needs 
to create a quick sign or banner at one point or another. While 
most printer utilities limit you to printing messages on a single sheet 
of paper, Easy Banner will print any message sideways, enabling you 
to create banners as long as your imagination or pockctbook allows. 

Although the program is deceptively short, Easy Banner is flexible 
enough to meet the needs of most occasions. It may be loaded in 
either (M28 40-Column mode or in C-64 mode, and there arc four 
options in the program. The first lets you choose the height of the 
characters you wish to print (1-8, smallest to largest). Then, under 
this option, you may wish to elect an expanded print character at 
the prompt, since the largest sizes (7 and 8) tend to be vertically 
elongated and thus hard to read at close range. 

The second option lets you specify the character you wish to print 
your banner with; this may be any Commodore keyboard character. 
Finally, select option three to enter the message you want printed, 
first making sure that the printer is connected and turned on, and 
that any special features have been disabled (most notably, skip-per- 
foration DIP switches). The fourth option lets you exit the program. 

Easy Banner will handle inputs of up to 80 characters at a time, 
which, believe me, will use a tremendous amount of paper. Of course, 
you may create longer messages by simply appending separate 
banners. 

The program should be compatible with most dot matrix and 
letter-quality printers. So next time, don't paint it. . .print it! — with 
Easy Banner. 
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RUN it right: C-128; in 40-Column mode 



Monkey See 



By Jerome Kmiltnr 



YOU'RE PROBABLY FAMILIAR with the game called Simon Says, 
or Follow Me. You may even have one of those little plastic boxes 
with four buttons on it— and a dead battery inside— linking in a 
closet. Well, here's a program for the C-128 that brings the game to 
life. Called Monkey See, it replaces the plastic box with the 40- 
coiumn screen and the C-I28's keypad. Instead of a blinking colored 
light, you see animated sprites on a colorful background, and the 
sound is much superior to the buzz of the original game. 

When you run the program, it boots up with the difficulty level 
set at E, for easy, but you can change that to medium, hard or 
impossible by pressing any key to cycle through the options, and 
then the return key to select your challenge. 

The screen shows four boxes, or "pads," arranged like the 2, 4, 6 
and 8 keys on the keypad, with a musical note sprite in the area in 
the middle. The computer plays a note by "pressing" on one of the 
pads with the movable note sprite. Then it waits for you to play the 
same note with keypad number 2, 4, 6 or 8. After you play the note, 
Monkey See ups the ante by playing the first note again, and then 
another. This pattern of adding notes continues until you make a 
mistake or exhaust the level you've preset. 

If you make a mistake, the screen offers the options of hearing 
the last sequence played correctly, starting the game again or quitting. 

Monkey Sec is written in Basic, with Data statements at the end 
for the sprite data and the actual key sequence. Don't think for a 
moment that the game won't be random enough with the key se- 
quences in an array. While the array holds a sequence of only 100 
keys, there are over 50 random starting positions. 

The listing lines are numbered by two's, so you can use your auto 
numbering system and still have room to add custom comments 
where needed. The difficulty levels are set in lines 98-104 and should 
provide the amount of challenge you need. The sprite movement 
is set in lines 88-96. A variable empty timing loop in those lines 
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keeps shortening the time between notes until cither you or the 
computer give up, 

One caution: Monkey See is good fun for all ages, so don't turn 
up the volume too loud. Otherwise, you'll have a number of people 
standing behind you, all yelling, "I'm next!" 



RUN it right: C-64; C-128 (in 40-Column mode) 



Scared Silly! 



By joey Latimer 



ONE CHARACTER YOU WOULD not want to be on Halloween is 
a pumpkin. You'd first suffer the horrible ordeal of getting your 
insides scooped out and your eyes, nose and mouth carved. Then 
you'd be placed outdoors, helpless in the black night and chill wind 
and at the mercy of ghosts and goblins and other terrifying monsters 
who want to squash you. 

So, instead of making a scary pumpkin, I made a scared pumpkin! 

His eyes dart from side to side in frantic desperation, hoping 
against hope that thh house will be overlooked by the trick or trcaters. 

Without warning, a sickly white flash lights up the night, followed 
by the sharp slap of thunder. And music! Where's that haunting 
music coming from! Another bright flash silhouettes a trick or neater 
gliding up the walk. The porch light pops on. No! It can't be! It's 
wearing an Ozzy Osborne outfit! Arrrggghhh!!! 

You can run Halloween Pumpkin on a C-64 or a C-128 in 40- 
Column mode. If you use C-128 mode, you'll notice that the pumpkin 
looks quite different. 

Put your scared pumpkin in a window — safe from the wicked 
night outside — and hope the tricksters and goblins will be kind on 
this Halloween. 
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RUN it right: C-64; printer recommended 

Tool for Teachers 

By Rick Kephart 



TEACHERS WHO ARE COMMODORF OWNERS will appreciate 
this Z -Scores program. Ii statistically analyzes test scores to produce 
a z-score for each student and then a more easily used "curved" 
grade derived from the z-score. It also generates a rank-ordered 
listing of the raw scores (the scores entered). 

Z-scores are based on the Standard deviation from the mean of 
the raw scores. Therefore, they normally remain quite constant from 
test to test, regardless of the difficulty of the lest. When a student's 
z-scores are consistently lower than those of most other students 
taking the same tests, he or she probably needs special help. Similarly, 
if a particular student's z-scores suddenly drop, he or she may be 
encountering a momentary difficulty that requires attention. 

Z-scores can indicate problems with a test, as well. If many of the 
z-scores for the test are inconsistent with the students' past records, 
the test design may have been faulty, or (he students may have been 
guessing too much, or even cheating. 

A z-score of is average. Positive z-scores are above average, and 
negative scores are below average. To make the z-scores more mean- 
ingful, the program plots them on a standard bell curve, then 
translates them into letter grades. The letter grades have the follow- 
ing meanings: A, far above average; B, above average; C, average; 
D, below average; F, far below average. The program also displays 
the average of the raw scores. 

You have a choice of an on-screen display or a printout. 1 rec- 
ommend a printout, especially when you have more than ten students 
taking a test. Both outputs consist of four columns — name, rank 
ordering of the raw scores, curved letter grades and z-scores— with 
the average of the raw scores below. 

Lines are skipped in the display or printout, except when identical 
raw scores have been earned. This makes the statistical mode— the 
most frequent score — in the rank ordering more apparent, II there's 
more than one mode— that is, if more than one score appears at 
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this greatest frequency — there may be a need for separate grouping. 

In addition to your choice of screen display or printout, you have 
the option of using a sequential disk Hie for inputting students' 
names. This file is created by Z-SCORES PRG2. Having the names 
on disk saves retyping them each time you run Z-Scorcs. However, 
you can't use file input if you don't have a score for every name in 
the file. 

When entering names and scores into the program, you can correct 
mistakes by typing - 1 at the next prompt. Pressing the return key 
without entering a name indicates that you're done with the names; 
pressing return while entering scores repeats a score. 

Note that only the first 15 letters of a name will appear in the 
screen display or printout. Also, scores must represent the number 
or percentage correct, not those wrong; no score can be less than 
zero or more than 127; and only whole numbers are allowed. 



RUN it right: C-64; joystick 

Joystick Mouse Emulator 

By Kenny Lawson 



WITH A JOYSTICK IN PORT 2, Joystick Mouse Emulator moves a 
pointer about the screen much as does a mouse input device. Load 
and run EMULATOR I, then load and run EMULATOR 2, which 
lists some typical commands on the screen, along with the pointer, 
calls the machine language routine and wails for the joystick to 
move the pointer. A formula computes the pointer's screen location 
(1024-2023 in default) when you press the fire-button. 

The pointer moves in the direction you press the joystick. When 
you move the tip of the pointer over a desired instruction, press 
the fire button to get a message identifying your selection. For 
instance, if you move the pointer to the Print option and press the 
fire-button, the screen displays the message "You called for Print". 

The data for the sprite shape begins at the eighth data clement 
in EMULATOR I on tine 220. Change this data to create other 
shapes. Data items 13 and 15 in line 200 change the speed at which 

is rerun- SEPTEMBF.raocrroBF.R iamb 



the pointer moves; I used values that make it move at a reasonable 
speed. 

You can use Joystick Pointer as a machine language subroutine 
in your own applications programs. Just use a Gosub command early 
in your own program to install the ML. Your programs will have to 
contain a series of If-Then statements, such as the demo program 
uses, to determine the action taken when you make a selection. 

Of course, in using the joystick routine in your own applications, 
you must map out the format of your own on-screen instructions, 
commands, options, and so on. The formula in line 70 of the demo 
program returns the number of the screen cell that the pointer 
occupied when you pressed the fire-button, by reading the sprite 
horizontal and vertical registers for the pixel number of the line 
and column of the sprite. For instance, for a pointer in the upper- 
left corner of the screen, P = 1024, the first screen location in default 
memory. 

To switch screen locations, adjust the formula by changing 1024 
to the number of the first byte of screen memory that your program 
uses; the joystick routine still works. 



RUN ii right: C-64 



Flipper 34 

By Francis O. Saffell 



FLIPPER 34 EXTRACTS the full potential of the little-used graphics 
characters of the C-64, and, like any good utility, it may be used in 
a variety of ways. As a stand-alone program, it creates and rapidly 
displays up to 34 pages of screen data that can be used to create 
short cartoons, op art or dazzling displays for window advertising. 
As a programming tool for your own programs, Flipper will create 
page sets that you may recall and display by incorporating the Hipper 
subprogram. 

How To Use the Programs 

Flipper uses an editing screen for creating pages, which are re- 
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trieved (fetched) or sent (stashed) to and from this editing screen. 
The screen works like the normal Basic screen editor, with a lew 
exceptions. The delete key now works as a backspace, and the insert 
key changes the characteristics of the cursor. Normally, Flipper S4's 
red cursor advances one space after placing a character. Pressing 
the insert key changes the cursor color to cyan and turns oil the 
auto-advance feature, thus making it easier to create vertical lines. 
Pressing the insert key again returns the red cursor. 

When creating pages with Flipper, you can use keyboard graphics 
characters. As most Commodore computerists know, holding down 
the Commodore key while pressing another key produces the graph- 
ics character depicted on the lower-left corner of the key. Holding 
down the shift key and pressing a key produces the lower-righl 
graphics character. To repeat a character with Flipper, first place it 
on the screen, then bring the cursor over it and press shift/return. 
The character is now captured. To place it onto the screen, press 
the return key. 

To simplify animation, newly placed characters are displayed in 
green. After you stash or fetch a page, all characters become white. 
Newly placed characters will then be green, which simplifies setting 
up new pages. Old white characters are quickly removed by pressing 
the control and 2 keys simultaneously. 

While you're editing, the top line displays a page-in value, a page- 
out value and the range. The page-in value denotes the most recently 
fetched page. You use the function keys to control page movement. 
Press the Fl key to move a page into the editing space. When starting 
out, you'll be retrieving whatever was left in memory. You can clear 
the edit screen with the clear key. 

You stash a screen by using the F3 and F5 keys. The page-out 
value is automatically incremented each time you press the F3 key, 
and this can be overwritten. The F5 key stashes the edit screen to 
the page-out location. The high-range value is automatically set to 
the highest stashed page. You can independently set the range values 
with the F2 key. The F4 key turns on the page-number and screen- 
address display feature. Here the otherwise inaccessible top line of 
the edit screen works to your advantage, because it automatically 
hides the top line during page-flipping. 

Pressing F6 loads a previously saved set of pages and automatically 
sets the range values. The F8 key saves all pages within the start and 
finish range values as individually numbered program files. Be 
careful when saving. All files with names that start with letters 
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matching the page-set name will be deleted before the save begins. 
Pressing the F7 key starts the flipping routine. While pages flip, you 
can adjust the speed with the plus and minus keys. To return to the 
edit screen, hold down the F7 key until the top information line 
reappears, then quickly release the key. You press the £ key to see 
a display of the function key definitions. Pressing the £ key again 
returns you to the edit screen. 

Creating a Two-Page Animation 

Load and run the Flipper program. Press the clear key and answer 
"y" to the prompt. Now press control/9. Push the Commodore/ + 
key combination, and then press control/0. You should then have a 
grid character in the upper-left corner. Now place the cursor over 
this character and press shift/return. Hold down the return key to 
fill the top line with this character. At the end of the line, press 
shift/insert to get the cyan cursor. 

Now, using the cursor-down key and the return key, fill the right 
horizontal border with the grid character. At the bottom of the 
screen, press the home key. Now fill the left border with the grid 
character. When the cursor reaches the bottom, press the insert key 
again to get the red cursor. Hold down the return key to fill the 
bottom line with grid characters. 

Now press the F5 key to send the contents of the screen to page 
1. Press the home key to return the cursor to the upper-left corner; 
then press the Commodore/ + key combination. This places the 
normal, non-reversed grid character on the screen. Place the cursor 
over this character and capture it with the shift/return combination. 
Now place that grid character over the old, reversed characters with 
the return key. 

When you are through, press the F3 key, followed by the return 
key, then finally the F5 key. This sends the positive grid characters 
to page 2, Press the F4 key and enter "y" for yes. This will display 
the page number and the screen address during animation. Now 
press the F7 key to view your two-page animation. You may alter 
the rate at which the pages change by holding down the plus or 
minus keys. To return to the screen editor, hold down the F7 key 
until the top display line reappears. 

You can now save these two pages and display them using the 
Flipper subprogram. Press the F8 key and enter a unique five- 
character filename, After the save, press the stop key, clear the screen, 
enter NFW and load the subprogram. Run the subprogram and 
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enter the page set name. The subprogram loads and displays your 
animation until you hold down the F7 key to hall the routine. 

Merging the Subprogram 

The subprogram is easily merged with your own programs. Simply 
load and list it to the screen. Bring the cursor up under the last 
line; then type NEW and press the return key. Bring the cursor up 
under the last line again and load your own program. After your 
program loads, bring the cursor up to the top line and press return 
over each of the line numbers. The subprogram is now appended 
to the end of your program. 

Let's See a Demo! 

An animated demonstration of Flipper 34 is on this ReRUN disk 
for your viewing enjoyment. Just activate Flipper 34, press the F6 
key and enter the Filename "WOW!" at the prompt. Wait about three 
minutes for all 34 pages to load in. Once the loading message 
disappears, press F7 to begin the animation process. As explained 
earlier, press + to speed up and - to slow down the animation. 
Hold down the F7 key to halt the animation process. 

PROGRAMMER'S NOTES ON PAGE SET FILES 

Page set files are of two types: individual screens stored as program 
Files, and sequential Files containing, among other things, the File- 
names of all the screens in that set. The sequential ".dir" file has 
the start and Finish range values of a page set. Individual page 
records comprise four fields. Field 1 contains a page program file- 
name; field 2 contains the value for bank selection; field 3 contains 
the VIC II screen offset value; and field 4 contains the high byte of 
the absolute screen location in memory. 

To maximize programming space at the start of your program, 
poke locations 52 and 56 with (he high byte of the starting address 
of your lowest page; then issue a Clear command. If your pages start 
at 22528 to 31744, you'll also have to protect the character data at 
20480 to 22527 by poking 52 and 56 with a value of 80. Location 
648 can also use the screen-location high byte to direct printing 
onto your animation. To get a screen's location, multiply the screen- 
location high-byte value by 256. ■ 
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14 Programs Included on this Disk 

Try To Remember * Programmer's Pager 
Knock! *- Inertia Mania ► Kracking the Kernal 

Instant Test-Maker > Easy Banners 
Tool for Teachers * Joystick Mouse Emulator 

From the September RUN: From the October RUN: 

+ Try To Remember ■► Songs in the Key of C- 1 28 

* Programmer's Pager ^ Instant Test-Maker 

* KnockI * Easy Banners 
- Inertia Mania * Monkey See 
*■ Vacation List Generator » Scared Silly! 

► Kracking the Kernal » Tool for Teachers 

> Joystick Mouse Emulator 

Plus: Extra Bonus Program! 

- Flipper 34 



II any manufacturing detect becomes apparent, the defective disk will be replaced free of charge If returned 
by prepaid mall within 30 days of purchase. Send it, with a feller specifying the defect, lo: 

BeflUN » 80 Elm Street ■ Peterborough, NH 034SB 

Replacements will not be made il the disk has bean allered, repaired or misused through negligence, or if it 
shows signs of excessive wear or Is damaged by equipment. 

The programs in BeRUN are taken directly from listings prepared lo accompany articles in RUN magazine 
They will not run under all system configurations. Use the RUN II Right information included with each article as 
your guide. 

The entire contents are copyrighted 19B8 by IDG Communications/Peterborough. Unauthorized duplication Is a 
violation of applicable laws. 
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